.TH mktape "1" "@MONTH@ @YEAR@" "mhvtl @VERSION@" "User Commands"
.SH NAME
mktape \- Utility to create new/blank virtual media for the VTL.
.SH SYNOPSIS
.B mktape \-h
.br
.B mktape REQUIRED_PARAMS
.BI [ OPTIONS ]
.B ...
.SH DESCRIPTION
.PP
Create and initialise new media for the Virtual Tape Library. Media is
created in the
.B @HOME_PATH@
directory by default. This can be over-ridden
using the 'Home directory:' setting in
.BR device.conf .
.SH OPTIONS
Options are from:
.TP
.B \-h
display this help and exit
.TP
.B \-V
Print version information and exit
.TP
.B \-v
Be verbose
.TP
.B \-D
Enter debugging mode (much each output)
.TP
\fB\-C\fR \fIconfig-dir\fR
Use
.I config-dir
instead of the default of
.BR @CONFIG_PATH@ .
.PP
Required options are:
.TP
\fB\-l\fR \fIn\fR
Where
.I n
is the library index number (default library index numbers 10 & 30).
The 'Home directory:' entry for the library specified is used as parent
directory for media created.
If the library index number does not exist, then a subdir under
@HOME_PATH@/<n>
is created and virtual media created in this directory.
For example "mktape -l 20 -m ABC123 -s 1024 -t data -d LTO3" will create a virtual
media
.I ABC123
in @HOME_PATH@/20/
if no library index 20 defined in
.BR device.conf .
.TP
\fB\-m\fR \fIPCL\fR
where
.I PCL
is the Physical Cartridge Label (barcode).
.TP
\fB\-s\fR \fIsize\fR
where
.I size
is the capacity of the virtual media - Size is defined in 'megabytes'.
.TP
\fB\-t\fR \fItype\fR
The media
.I type
which can be:
.BR data ,
.B WORM
(Write Once Read Many),
.B clean
(cleaning cartridge) or
.B NULL
for media which does not save data.
.PP
The
.B NULL
is a special media type used primarily to test performance with disk
writes kept to a minimum. Note: Metadata (512bytes per data block) is still
written.
.TP
\fB\-d\fR \fIdensity\fR
Media
.IR density .
Can be one of
.BR LTO1 ,
.BR LTO2 ,
.BR LTO3 ,
.BR LTO4 ,
.BR LTO5 ,
.BR LTO6 ,
.BR LTO7 ,
.BR SDLT1 ,
.BR SDLT2 ,
.BR SDLT3 ,
.BR SDLT4 ,
.BR AIT1 ,
.BR AIT2 ,
.BR AIT3 ,
.BR AIT4 ,
.BR T10KA ,
.BR T10KB ,
.BR T10KC ,
.BR 9840A ,
.BR 9840B ,
.BR 9840C ,
.BR 9840D ,
.BR 9940A ,
.BR 9940B ,
.BR J1A ,
.BR E05
and
.BR E06 .
.PP
The
.BR J1A ,
.B E05
and
.B E06
media densities refer to the IBM 03592 media types.
.SH AUTHOR
Written by Mark Harvey
.SH BUGS
Needs to be made user friendly.
.SH "REPORTING BUGS"
Report bugs to <markh794@gmail.com> <mark.harvey@nutanix.com>.
.SH COPYRIGHT
Copyright \(co 2018 Free Software Foundation, Inc.
.br
This is free software; see the source for copying conditions.  There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
.SH "SEE ALSO"
.BR make_vtl_media(1) ,
.BR library_contents(5) ,
.BR vtlcmd(1) ,
.BR vtllibrary(1) ,
.BR vtltape(1) ,
.BR edit_tape(1) ,
.BR generate_device_conf(1) ,
.BR generate_library_contents(1)
